home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / joked_02.zip / JOKEDOOR.DOC < prev    next >
Text File  |  1992-09-02  |  13KB  |  314 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                       ▄▄▄▄▄▄▄▄   ▄▄▄▄▄▄▄▄   ▄▄   ▄▄   ▄▄▄▄▄▄▄▄
  17.                      ▓▓▓▓▓▓▓▓▀  ▓▓▓▓▓▓▓▓█  ▓▓█  ▓▓▀  ▓▓▓▓▓▓▓▓▀
  18.                         ▓▓█     ▓▓█   ▓▓█  ▓▓█ ▓▓▀   ▓▓█
  19.                         ▓▓█     ▓▓█   ▓▓█  ▓▓█▓▓▀    ▓▓█▄▄▄
  20.                         ▓▓█     ▓▓█   ▓▓█  ▓▓▓▓█     ▓▓▓▓▓▀
  21.                     ▄▄  ▓▓█     ▓▓█   ▓▓█  ▓▓█▓▓▄    ▓▓█
  22.                    ▓▓█▄▄▓▓█     ▓▓█▄▄▄▓▓█  ▓▓█ ▓▓▄▄  ▓▓█▄▄▄▄▄▄
  23.                     ▓▓▓▓▓▓▀     ▓▓▓▓▓▓▓▓▀  ▓▓▀  ▓▓▀  ▓▓▓▓▓▓▓▓▀
  24.  
  25.                     ▄▄▄▄▄▄      ▄▄▄▄▄▄▄▄   ▄▄▄▄▄▄▄▄   ▄▄▄▄▄▄
  26.                    ▓▓▓▓▓▓█▄    ▓▓▓▓▓▓▓▓█  ▓▓▓▓▓▓▓▓█  ▓▓▓▓▓▓█▄
  27.                    ▓▓█  ▓▓█▄   ▓▓█   ▓▓█  ▓▓█   ▓▓█  ▓▓█  ▓▓█
  28.                    ▓▓█   ▓▓█▄  ▓▓█   ▓▓█  ▓▓█   ▓▓█  ▓▓█▄▄▓▓█
  29.                    ▓▓█    ▓▓▀  ▓▓█   ▓▓█  ▓▓█   ▓▓█  ▓▓▓▓▓▓▀
  30.                    ▓▓█   ▓▓▀   ▓▓█   ▓▓█  ▓▓█   ▓▓█  ▓▓█▓▓█▄
  31.                    ▓▓█▄▄▓▓▀    ▓▓█▄▄▄▓▓█  ▓▓█▄▄▄▓▓█  ▓▓█ ▓▓█▄
  32.                    ▓▓▓▓▓▓▀     ▓▓▓▓▓▓▓▓▀  ▓▓▓▓▓▓▓▓▀  ▓▓▀  ▓▓▀
  33.  
  34.  
  35.                                   Version 0.2
  36.  
  37.                               (C) 1992 by Mike Burns
  38.  
  39.  
  40.  
  41.                           ╔═══════════════════════════╗
  42.                           ║█▓▒░    Legal Things   ░▒▓█║
  43.                           ╚═══════════════════════════╝
  44.  
  45.  
  46.            Mike Burns no warranties, expressed or implied, as to the quality
  47.            or performance of this program. Mike Burns only gauranties that
  48.            this program will take up space on your storage media, and
  49.            almost half a meg at that. Mike Burns will not be held liable for
  50.            any direct, indirect, incidental or consequential damages
  51.            resulting from the use of this program.  Your use of the program
  52.            constitutes your agreement to this disclaimer and your release
  53.            of Mike Burns from any form of liability, litigation or phisical
  54.            harm. *8-}.
  55.  
  56.  
  57.  
  58.                           ╔═══════════════════════════╗
  59.                           ║█▓▒░ Sharware or ....  ░▒▓█║
  60.                           ╚═══════════════════════════╝
  61.  
  62.  
  63.            JokeDoor is not really Shareware, and not quite Freeware. The
  64.            first version of JokeDoor was written for myself, and then was
  65.            released as Cardware due to some pushy fellow SYSOPS. After
  66.            releasing Ver 0.1, I was swampped with suggestions for a new
  67.            and better version. Well here it is. You are granted a users
  68.            license for the period of 99 years. You are not required to
  69.            register JokeDoor, but for those of you that wish to do so
  70.            will find a lot more features. Please see the REGISTER.DOC file
  71.            for more info.
  72.  
  73.                           ╔═══════════════════════════╗
  74.                           ║█▓▒░   JokeDoor Info   ░▒▓█║
  75.                           ╚═══════════════════════════╝
  76.  
  77.            You will need two things for JokeDoor to Operate properly,
  78.            a copy of PKZIP.EXE some where in your path, and a copy of
  79.            SHROOM.COM and DSZ.EXE in JOKEDOOR's dir. SHROOM.ZIP and
  80.            DSZ1001X.ZIP has been sent to you inside this archive. These
  81.            are included for ease only, they are also Shareware programs,
  82.            please read the docs for these programs, you may find that you
  83.            can uses one or the other, your self for many more things.
  84.  
  85.            REGISTRATION CODES FOR VER 0.1 WILL !!! NOT !!! WORK FOR THIS
  86.            VERSION JOKEDOOR.
  87.  
  88.  
  89.  
  90.                           ╔═══════════════════════════╗
  91.                           ║█▓▒░   JokeDoor Setup  ░▒▓█║
  92.                           ╚═══════════════════════════╝
  93.  
  94.  
  95.            Setting up JokeDoor is very easy. Unachive all files into a
  96.            directory { Why do we say that?, your reading this so you must
  97.            have done that already!}. Anyways, then run JDCONFIG to do the
  98.            actual setup. Most of the stuff is pretty straight forward, and
  99.            should not need much explaning { I hate writing Doc's so I'll
  100.            this short and simple }. Once you run JDCONFIG you will find
  101.            the opening screen with your options across the top.
  102.  
  103.              INFO  -  General Info about JokeDoor
  104.  
  105.              General Setup - Things like Sysop & BBS name
  106.  
  107.              JokeDoor Options - What you want JokeDoor to Do
  108.  
  109.              Areas  - This is where you will setup your Joke Areas
  110.  
  111.            Ok, I guess we'll start with "GENERAL SETUP" you can look in
  112.            "INFO" but it doesn't do anything for the setup.
  113.  
  114.               GENERAL SETUP
  115.              ===============
  116.  
  117.              1. SYSOP NAME   - This one is very diffacult, this is where you
  118.                                you put your name. You must make sure that it
  119.                                is exactly the same as what your BBS Drop File
  120.                                says it is.
  121.  
  122.              2. BBS Name     - Same as above, but you put your BBS name here.
  123.                                Please remember that if your Drop file says
  124.                                eg. "THE POWER LEVEL BBS", that
  125.                                "THE POWER LEVEL" is not the same thing.
  126.  
  127.              3. Registration - If you register JokeDoor, this is where you
  128.                                put your registration code.
  129.  
  130.              4. Path to BBS  - This is the path to your BBS drop file.
  131.                                You must make sure that you include the
  132.                                trailing backslash!!
  133.  
  134.              5. Path to JD   - This is the path to where JokeDoor is stored.
  135.                                As above, you must make sure that you include
  136.                                the trailing backslash!!
  137.  
  138.              6. Dropfile     - As of now JokeDoor only supports two styles
  139.                                of Dropfiles. "DORINFO1.DEF" and "DOOR.SYS".
  140.                                Select the one you wish to use.
  141.  
  142.            This ends the General Setup, now we will move on to JokeDoor
  143.            options.
  144.  
  145.               JOKEDOOR OPTIONS
  146.              ==================
  147.  
  148.              1. Sysop Security - This is used in the online maintenance
  149.                                  to tell JokeDoor you are the Sysop.
  150.  
  151.              2. Co Security    - If you wish your Co-Sysop to be able to do
  152.                                  maintenance in JokeDoor set this to his/her
  153.                                  security level.
  154.  
  155.              3. Holding File   - If this option is set to Yes then all jokes
  156.                                  that users enter will not enter the data base
  157.                                  until you or your Co-Sysop "Approve" the joke.
  158.                                  If this is set to No then all new jokes will
  159.                                  be available immediately.
  160.  
  161.              4. See Who        - All users that have a security level equal to
  162.                                  or above this setting will be able to see
  163.                                  who wrote the joke. Users below this level
  164.                                  will not be able to see who wrote the joke.
  165.  
  166.              5. Downloads      - Set this option to NO, if for some reason you
  167.                                  do not want your users to be able to download
  168.                                  jokes.
  169.  
  170.              6. Co Delete      - You can decide just how much maintenace your
  171.                                  Co-Sysop can do. Set this option to YES if
  172.                                  you wish him/her to be able to delete jokes.
  173.  
  174.              7. Co Approve     - As above set this option to YES if you wish
  175.                                  your Co-Sysop to be able to Approve jokes.
  176.  
  177.              8. Log File       - Set this to YES if you wish JokeDoor to create
  178.                                  a Log File.
  179.  
  180.              9. Error Log      - Set this to YES if you wish JokeDoor to create
  181.                                  a log file of all <shudder> errors.
  182.  
  183.            This ends the JokeDoor Options, now we'll move on to the AREAS Setup.
  184.  
  185.              AREAS
  186.             =======
  187.  
  188.             This is where you configure Jokedoor for the areas that you wish
  189.             to have available on your system. Areas 1-5 are for Q-A type Jokes,
  190.             Areas 6-10 are for Story type Jokes. The story Joke areas are up to
  191.             60 lines for each Joke and have a built in line editor. The Q-A
  192.             Joke areas are 3 lines for question, and 3 lines for the punchline.
  193.  
  194.  
  195.             1. Area Name    - This is what you want that area to be called.
  196.                               JokeDoor will format this later, so please do not
  197.                               put "JOKES" after it. If this area is not used
  198.                               then it must be named "** Unused **".
  199.                               eg.  "Blond" will become "Blond Jokes".
  200.  
  201.             2. Max Jokes    - Set this to the maximum number of Jokes that you
  202.                               want to be in this area. If not registered this
  203.                               is set to 20 for each area.
  204.  
  205.             3. Days to Keep - Set this to the number of days that the Joke will
  206.                               stay on the system for. All Jokes older than this
  207.                               will be set for deletion. If not registered then
  208.                               this is set to 30 days.
  209.  
  210.             4. Secur. Level - This is the minimum security level a user will
  211.                               have to have to access this area. All users below
  212.                               this will not be able to get into this area.
  213.  
  214.             5. Secur. Delete- This is here for future upgrades, and is not used
  215.                               at this point.
  216.  
  217.  
  218.            Well now JokeDoor is configured for your system. You can now go and
  219.            check out the program if you wish, but please come back and read
  220.            about the Maintanance that JokeDoor needs.
  221.  
  222.  
  223.  
  224.                           ╔═══════════════════════════╗
  225.                           ║█▓▒░    Maintanance    ░▒▓█║
  226.                           ╚═══════════════════════════╝
  227.  
  228.            Jokedoor needs to have maintanace run every night. Here is a list
  229.            of commands and what they do.
  230.  
  231.            syntax:  JokeDoor [Options]
  232.  
  233.              /M       - Runs general maintanace that is needed every night.
  234.  
  235.              /P       - Packs the Database files
  236.  
  237.              /Ux      - Deletes users that have not been in x days eg. /U30
  238.  
  239.          (R) /A{area} - Deletes all Q-A Jokes in {area}
  240.  
  241.          (R) /B{area} - Deletes all Story Jokes in {area}
  242.  
  243.          (R) /Dx      - Deletes all Jokes older than x days. Including Jokes
  244.                         set for NoKill.
  245.  
  246.          (R) /W       - Will give a report on the number of Jokes in each
  247.                         area, as well as the number of users in the DataBase.
  248.  
  249.          All features with the "(R)" are not needed to run JokeDoor and are
  250.          bonus features for registed users.
  251.  
  252.          You should use the "/M" evry night, and the "/P" & "/U" once a week
  253.          or so. Not usesing the "/M" will cause problems with JokeDoor.
  254.  
  255.  
  256.                           ╔═══════════════════════════╗
  257.                           ║█▓▒░  Running JokeDoor ░▒▓█║
  258.                           ╚═══════════════════════════╝
  259.  
  260.  
  261.          Running JokeDoor is very easy. To run JokeDoor in Local mode type
  262.          " JOKEDOOR /L ". To run it as a door you need to pass JokeDoor two
  263.          paramaters.
  264.  
  265.            Your batch file to run JokeDoor should look something like this.
  266.  
  267.            JOKES.BAT
  268.            =========
  269.            @ECHO OFF
  270.            CD\BBS\ONLINE\JOKEDOOR
  271.            JOKEDOOR.EXE  /N1 /RC:\BBS\
  272.            CD\BBS
  273.            EXIT
  274.  
  275.            Where "/Nx" is the node number of the dropfile,
  276.                  "/R{path}" is the full path to your dropfile.
  277.                  !!! Path must have the trailing backslash !!!!
  278.  
  279.  
  280.          Thats all there is to setting up JokeDoor. If you have any problems
  281.          or suggestions, I can be reached by one of the following methods
  282.  
  283.             Electronic Mail:
  284.  
  285.                75:8010/101 @DoorNet
  286.  
  287.                1:153/721   @FidoNet
  288.  
  289.             Snail Mail :
  290.  
  291.                Mike Burns
  292.                #102 315 10th St.
  293.                New Westminster,B.C.
  294.                Canada, V3M3Y2
  295.  
  296.          I am still looking for ßeta sites for this and other Door programs
  297.          that will be coming out soon. If you wish to become a ßeta test site
  298.          please fill out the ßeta App. and mail it back to me. All ßeta testers
  299.          recieve registered copies.
  300.  
  301.          Special thanks goes out to :
  302.  
  303.                    Mark Henter                 Russ Stackhouse
  304.                    Agape BBS           and     Online Access
  305.                    1-604-931-1461              1-604-945-0833
  306.                    1-604-931-1463
  307.  
  308.              For their support in testing all the buggy stuff.
  309.  
  310.          And to my wife, who was not quite understanding but put up with
  311.          me anyway.
  312.  
  313.  
  314.